home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u286.dms / u286.adf / ARP / ARPManual / Rename < prev    next >
Text File  |  1991-07-28  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4.      Rename(REL2)         ARP User's    Manual          Rename(REL2)
  5.  
  6.  
  7.  
  8.      NAME
  9.       Rename - To rename or    move files and directories.
  10.  
  11.      SYNOPSIS
  12.       Rename FILE TO FILE or directory.
  13.  
  14.      DESCRIPTION
  15.       Rename changes the names of your files.  If the file already
  16.       exists, or if    you attempt to Rename a    file from one disk
  17.       device to another, Rename will fail. You may use wildcards
  18.       to move many files from one filename to another, or you may
  19.       use wildcards    to move    many files from    one directory to
  20.       another. Note    that using Rename to move files    is quicker and
  21.       cleaner than using Copy and then delete.
  22.  
  23.       The wildcards    supported for the creation of the destination
  24.       name is the similar to that used by the ARP Copy command.
  25.       There    are basically two types:
  26.  
  27.            Rename Filename    <opt_prefix>*<opt_postfix>
  28.  
  29.       In this case,    when the original filename does    not use    the
  30.       "*" character, the optional prefix and postfix if supplied
  31.       will be tacked on to the source name.     You can supply    one or
  32.       both of these    optional extensions, but it is possible    to
  33.       exceed the length of an AmigaDOS filename, in    which case
  34.       your filename    will be    silently truncated to fit.
  35.  
  36.       The second case is more powerful:
  37.  
  38.            Rename Filename*     <opt_prefix>*<opt_postfix>
  39.       or
  40.            Rename *Filename     <opt_prefix>*<opt_postfix>
  41.  
  42.       It works like    this:
  43.  
  44.       source:      Filename    *
  45.       action:      <replace> <preserve> <add>
  46.       destination:      opt_prefix    *      opt_postfix
  47.  
  48.       and
  49.  
  50.       source:            *      Filename
  51.       action:        <add>   <preserve> <replace>
  52.       destination:      opt_prefix    *      opt_postfix
  53.  
  54.       In otherwords, the portion of    the filename represented by
  55.       the *, the wildcarded    portion, is always copied to the
  56.       destination name, the    optional postfix's and prefixes    are
  57.       also copied literally.  The difference in these two cases is
  58.       only which optional extension    replaces the non-wildcarded
  59.       portion of your source filename.
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/22/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      Rename(REL2)         ARP User's    Manual          Rename(REL2)
  71.  
  72.  
  73.  
  74.      EXAMPLES
  75.       Here are some    examples to make things    clearer, starting with
  76.       the easiest first (these are also the    most frequently    used
  77.       and useful):
  78.  
  79.            Rename File1 File2
  80.            Rename File1 DIRECTORY
  81.            Rename File* DIRECTORY
  82.  
  83.       In the above three examples, we see a    files name being
  84.       changed (File1 becomse File2), we see    a file being moved
  85.       into another directory, and we see a lot of files being
  86.       moved    into another directory.     These are by far the most
  87.       common uses of Rename.
  88.  
  89.       Here are a couple examples of    the pattern substitution
  90.       capabilities of ARP's    Rename.     Given the files AB1 AB2 AB3,
  91.       the following    command:
  92.  
  93.            Rename AB* xxx*zzz
  94.  
  95.       fi
  96.       will rename the files    to xxx1zzz, xxx2zzz, xxx3zzz respectively.
  97.       Note that the    common portion of the pattern "AB" has been
  98.       replaced by the prefix, the stared part of the pattern is copied
  99.       literally, and the postfix is    simply added on    to the end of that.
  100.       Given    the files 1AB 2AB 3AB and the command:
  101.  
  102.            Rename *AB xxx*zzz
  103.  
  104.       would    also rename the    files to xxx1zzz xxx2zzz, xxx3zzz, but
  105.       in this case the portion replaced is the postfix end.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 2/22/88)
  130.  
  131.  
  132.  
  133.